home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / doors_1 / gwedit31.zip / GWEDIT31.DOC < prev    next >
Text File  |  1992-03-04  |  17KB  |  319 lines
  1.                           GWAREDIT Release 3.1!
  2.                   Copyright (c) 1991-1992 James N. Helm
  3.                             Shareware Release
  4.  
  5.      Thank for you trying out GWAREDIT Release 3.1! This program took many 
  6. hours of work and much effort. I would like to ask that you please register 
  7. this program if you find it useful and intend on using it for any length of 
  8. time. Without registration, you will NOT be able to save any of the games you 
  9. edit. The first two releases are NOT Shareware, and may be distributed as you 
  10. see fit. This version is the only one that will edit the new Global War 2.40
  11. games. To register, you can send $10 to James Helm. This will allow you to
  12. optain a REGISTRATION CODE from his BBS. If you cannot call out, or you
  13. are long distance, you can obtain the latest version on floppy disk, along
  14. with your personal REGISTRATION CODE by sending an extra $5 ($15 total), 
  15. along with the registration form (REGISTER.FRM) included with this file. You 
  16. can send any checks to (I wouldn't recommend sending cash through the mail):
  17.  
  18.                         James N. Helm
  19.                         13 Rickover Ct.
  20.                         Annapolis MD  21401
  21.  
  22. You can also reach me at my BBS:
  23.  
  24.                         The Endless Quest
  25.                         (410) 267-7376
  26.                         WWIVnet 1@3116 (* At the time of this release, I
  27.                                           may not be officially on the NET.
  28.                                           Just keep checking, and I should
  29.                                           be NET validated shortly. *)
  30.  
  31.      If you have REGISTERED GWAREDIT, and you find an error that is
  32. considered valid, and major, I will glady send you out a NEW copy of the
  33. editor on floppy disk FOR FREE. I want to maintain the highest standards for
  34. GWAREDIT, and make it as perfect as possible. Please report any errors
  35. immediately to me; either through my BBS or through the mail.
  36.  
  37.      Please include the registration form with any money, so I know who to
  38. give the proper access to, or where to send the floppy disk. YOU ONLY HAVE TO
  39. PAY ONCE! Once you have sent at least $10 registration fee, you will ALWAYS be
  40. allowed to download future versions of GWAREDIT from my BBS at NO CHARGE.
  41. Thank you for trying GWAREDIT Release 3.1! Please support future versions and
  42. Shareware development!
  43.  
  44. *** Jump to the end of this file for new features ***
  45.  
  46. Files that should have come with this archive:     
  47.  
  48.                                GWAREDIT.EXE  (Main Program)
  49.                                GWAREDIT.MAP  (Global War Maps)
  50.                                GWEDIT31.DOC  (This File)
  51.                                REGISTER.DOC  (How to use your REG Code)
  52.                                REGISTER.FRM  (Registration Form)
  53.                                VERSION .     (Current GWAREDIT Version #)
  54.  
  55. ------------------------------------------------------------------------------
  56.      
  57.      When you first run GWAREDIT you will see a screen letting you know if it's
  58. registered or not, and giving you some general information about how and where
  59. you should run GWAREDIT. You should take a minute to read through this screen.
  60.  
  61.      After the opening screen, you will see a line at the top of the screen
  62. with four possible commands: Edit a game, Generate a game, List valid files,
  63. and of course, Quit.
  64.  
  65.  
  66. +=============+
  67. | EDIT A GAME |
  68. +=============+
  69.  
  70.   Top of screen data
  71.   ------------------
  72.  
  73.      If you press E, it will pop up a line asking you to enter the number of
  74. the game you wish to edit. Just enter the game number, and it will then
  75. display the edit screen. At the top of this screen, there will be a portion of
  76. it sectioned off. In this top portion, is basic game information. It will tell
  77. you what TYPE of game it is, the number of players in the game, the game
  78. number, fortification information, if the player names are Hidden or Known,
  79. and how many sets of commendations have been turned in. (Depending on which
  80. version of Global War, you will get different fortification information.) In
  81. the latest GWAR version, (v2.40+) it will also tell you the "Play-Sequence"
  82. status. There will be a separation line, and under that will be Player and
  83. Country options. Most of these values CAN be changed. You can make the player
  84. names either Hidden or Known, change the play-sequence (for v2.40+ only) to
  85. either Non-Sequential or Sequential, you can change the number of
  86. fortification moves allowed (for v2.40+ only) to anything from 0-99, or if you
  87. are using v2.32 or earlier, you can change the fortifications to Limited or
  88. Unlimited. You also have the option to change the number of sets of
  89. commendations turned in so far, 0-99. (It will display to the right of that
  90. how many armies the next set will be worth.) All you have to do is press the
  91. number that is in front of each of these values, and it will prompt you for
  92. the rest.
  93.  
  94.   Player editor
  95.   -------------
  96.  
  97.      You will see the players names who are in that current game. They will
  98. appear in the same colors you would see them in Global War, and likewise, if
  99. they are dead in that game, they will be grey. To edit a player, just type the
  100. number that appears before their name, and press ENTER. It will then display a
  101. screen all about that particular player. At the top of this screen, you will
  102. see the player name, when they last took their turn (in days), their total
  103. armies, and how many commendations they have from the General, King and Queen.
  104. You edit all of these, except total armies, by pressing the number that is
  105. before each of them, and pressing ENTER. The name CANNOT be more than 17
  106. Characters long. If you enter in more than 17, it will just chop off the extra
  107. letters at the end. You can change when that player last took their turn, from
  108. anywhere to 0 days to 50. Also, for the commendations you can set that value
  109. from 0-99. (NOTE: Be careful when dealing with commendations! Check how many
  110. armies they have total, and what the next set will be worth. If you give a
  111. player armies that are MORE than 32767, Global War will have ERRORS!)
  112.  
  113.      There will be a separation line between that and the players countries.
  114. The countries are display by continent. You will see ALL the countries that
  115. appear on the map. The ones that particular player owns will be highlighted.
  116. The amount of armies that that country contains will follow. To edit the
  117. number of armies in any of the countries, simply press the number that is
  118. before the country you want, and enter a value between 1 and 999. To leave the
  119. player editor, type 48 and press ENTER.
  120.  
  121.   Display map
  122.   -----------
  123.  
  124.      After you are back out in the main menu, underneath the player names you
  125. will see more commands. 7, is the DISPLAY MAP feature. You MUST have a file
  126. called GWAREDIT.MAP that should have come with the editor. If it is not in the
  127. directory where GWAREDIT is running, you CAN still run GWAREDIT, but you will
  128. not be able to use this feature. Once you press 7, the familiar Global War map
  129. will appear in front of you. You will start off on the GLOBE. To change which
  130. map you see, simply press numbers 1-7, or 8 to Quit. (The map names will
  131. appear to your right, along with player names and game number.)
  132.  
  133.   Country ownership
  134.   -----------------
  135.  
  136.      Under the Display Map feature, you will see a command called COUNTRY
  137. OWNERSHIP. Once you select country ownership, you will see a new screen with
  138. all the countries displayed by continent, along with the player names across
  139. the top. The countries will be in different colors, depending on which player
  140. owns them. Just press the number in front of the country, and it will tell you
  141. who owns it, and ask you to enter the number of the player you wish to own it.
  142. It will then change the countries color to the new player color. If you take
  143. all the countries away from one person, they will be eliminated from the game,
  144. and that person's color will change to grey. To exit, type 43 and press ENTER.
  145.  
  146.   Edit a new game
  147.   ---------------
  148.  
  149.      The "Edit a new game" command is used when you want to leave the game
  150. you are currently in, and either generate a new game, or edit another one. If
  151. you press 9, it will ask if you would like to save your changes to this game.
  152. If you press Y, it will tell you when the data has been saved. After you press
  153. a key, it will return you to the beginning four commands. You can then choose
  154. to Edit another game, Generate a new game, List the valid files, or Quit.
  155.  
  156.   Quit GWAREDIT
  157.   -------------
  158.  
  159.      This command is fairly self explanatory.  When you enter 10, it will
  160. ask you if you would like to save the current game. Press either Y (Yes), N
  161. (No), or A (Abort). If you press A, it WON'T exit the program. It will return
  162. to the game you are currently editing. If you press Y, it will save the game,
  163. then drop you to DOS. If you press N, it will instantly drop you to DOS. This
  164. will end your GWAREDIT session.
  165.  
  166.  
  167. +=================+
  168. | GENERATE A GAME |
  169. +=================+
  170.  
  171.      When you select Generate a game, it will first prompt you with a
  172. question, "Generate a game Before, or After Global War v2.40?" If you have the
  173. latest version of Global War, (2.40 or later), the .DAT files are slightly
  174. changed, with different values. If you aren't sure, enter B for before, Global
  175. War 2.40 WILL read in and use the old .DAT files. (But, if you do have version
  176. 2.40, you have certain extra options that will enhance the users' enjoyment of
  177. the game.) If you select A or B, you will get a list of questions.
  178.  
  179.         1) Normal or Team game?
  180.              a) If you select TEAM game, it will automatically assume 6
  181.                 players.
  182.              b) If you select NORMAL game, you will be able to choose between
  183.                 3-6 players.
  184.  
  185.         2) Hidden or Known player names?
  186.              a) If you select HIDDEN, the other players in that game won't be
  187.                 allowed to see the other players names, until the game is
  188.                 over, or the other player is dead.
  189.              b) If you select KNOWN, all the players will know exactly who
  190.                 is playing in the game with them.
  191.  
  192. v2.32   3) Limited or Unlimited fortifications?
  193.              a) This question will not be asked if you selected v2.40 and
  194.                 after.
  195.              b) With LIMITED fortifications, players will only be allowed to
  196.                 make 1 fortification move.
  197.              c) With UNLIMITED fortifications, players will be allowed to
  198.                 fortify their armies until they are done.
  199.  
  200. v2.40   3) Should Play-Sequence be Sequential, or Non-Sequential?
  201.              a) This question will not be asked if you selected v2.32 and
  202.                 before.
  203.              b) If you select NON-SEQUENTIAL, the players will be allowed to
  204.                 Deploy-Attack-Fortify in ANY order they choose.
  205.              c) If you select SEQUENTIAL, the players will have to go through
  206.                 a Deploy phase, an optional Attack phase, and finally an
  207.                 optional Fortify phase.
  208.  
  209. v2.40   4) How many fortification moves allowed?
  210.              a) This question will not be asked if you selected v2.32 and
  211.                 before.
  212.              b) For versions 2.40 and after, there are no more "Unlimited
  213.                 fortifications."  You have to select the number of
  214.                 fortifications the players are allowed to have between 0 and 99.
  215.  
  216.         4) If you selected a NORMAL game, it will ask you how many players
  217.            in this game, 3-6?
  218.  
  219.         5) It will then prompt you for each player name, depending on how
  220.            many you have chosen, or 6 for a TEAM game.  (NOTE:  It will
  221.            accept ANY character from the keyboard, so be careful to spell
  222.            the users' names correctly.)
  223.  
  224.         6) Would you like to save this game?
  225.              a) If you choose YES, it will inform you that this game has
  226.                 begun, and return you to the beginning menu.
  227.              b) If you select NO, it will put you back at the beginning menu.
  228.  
  229.  
  230. +==================+
  231. | LIST VALID FILES |
  232. +==================+
  233.  
  234.      When you select List valid files, GWAREDIT will search the current
  235. directory for files it thinks are Global War files, checks them to see if they
  236. are in progress, and determines if they are TEAM or NORMAL games. It will list
  237. them by number (In the order it finds them in the directory, NOT by numeric
  238. order). If the game is a NORMAL game, it will appear in GREEN. If it is a TEAM
  239. game, it will appear in BLUE. A color-key will be on the screen, so you don't
  240. have to remember which is which.
  241.  
  242.  
  243. +======+
  244. | QUIT |
  245. +======+
  246.  
  247.      When you select Quit from this menu, it will automatically drop you to
  248. DOS, and display an information screen. This will end your GWAREDIT session.
  249.  
  250.  
  251.      Thank you for trying GWAREDIT, this tool can be very useful for SysOp's
  252. who like to have Global War tournaments, or select certain types of games for
  253. fun. This can also help if your computer TIME CLOCK get's disrupted somehow,
  254. and causes Global War to give you errors. (It's helped me quite a few times.)
  255. It can also be used by a SysOp to just see what's going on in Global War.
  256.  
  257.      I would like to thank the many people who have helped me test this,
  258. check for errors, etc. One of them in particular is Jeffery Qualey. He helped
  259. me write this DOC file, as well as helping me with the grammar/aesthetics
  260. portion of GWAREDIT. Much thanks to Jeff. Also Joel Bergen, the author of
  261. Global War, for helping me tremendously, and even donating pieces of his
  262. actual Global War source code for the development of the editor. Without him,
  263. much of this wouldn't have been in this version.
  264.  
  265.      A quick reminder, GWAREDIT is the product of many hours of hard work, and
  266. has been written for YOU. I only ask a small fee for it's use; one that I
  267. think is fair. Please register your copy with the author, James Helm.
  268.  
  269. ____________________________________________________________________________
  270.  
  271.                             Version Information
  272.  
  273. Release 1:    Very first release of the editor.  Not very easy to use for
  274.               Sysops.  Did not contain the Global War MAPS, and did not allow
  275.               as many changes to the actual game configuration.
  276.  
  277. Release 2:    MANY bugs were found and fixed with Release 1.   This version
  278.               also added the complete Global War MAPS, and added the ability
  279.               to change many of the game configurable values, such as number
  280.               of commendations turned in, player name status, etc.  It also
  281.               added the ability to change the day at which the player last
  282.               took their turn.  Players that were dead would have their name
  283.               appear in GREY, instead of the normal player color.  List Valid
  284.               Files was improved to display the filenames across the screen,
  285.               instead of down, so more file names at one time could be viewed.
  286.  
  287. Release 3:    This version will edit both Global War games before AND after
  288.               version 2.40.
  289.  
  290.               First SHAREWARE release of GWAREDIT.  This feature greatly
  291.               improved on the second release.  It simplified the MAP display
  292.               features, changed the country layout for both the Player Editor
  293.               and Country Ownership menus to display them by continent, instead
  294.               of a random-type sequence.  This improves editing ease greatly,
  295.               because it does not require the Sysop to have immediate knowledge
  296.               of the Global War maps to know which country is in what continent.
  297.  
  298.               Added a Game Generator.  This will allow a Sysop to create Global
  299.               War games, both version 2.32 and before and 2.40 and after.  This
  300.               can come in handy for people who like to hold tournaments with
  301.               Global War, and need to create certain games with certain players
  302.               involved.
  303.  
  304.               Improved the List Valid Files feature to ONLY display the Global
  305.               War game number, not the entire file name.  It will also display
  306.               TEAM and NORMAL type games in different colors.
  307.  
  308.               The Edit a Game feature now only requires the Sysop to enter the
  309.               Global War game number, instead of the entire filename.  It will
  310.               also display ONLY the game number at certain points in the 
  311.               editor, where it used to display the entire filename.
  312.  
  313. *Release 3.1: This version is bascially the same as Release 3, but it adds a
  314.               registration code, instead of a generic registration.  Also, it
  315.               combines the REGISTERED and UNREGISTERED versions into one file
  316.               instead of two.
  317.  
  318. * - Current version
  319.